home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 34 / Mac Magazin and MacEasy Magazine CD - Issue 34.iso / Office / trueTools / read me's / trueConvert < prev    next >
Text File  |  1996-11-28  |  3KB  |  79 lines
  1. trueConvert
  2.  
  3. trueConvert converts stacks that use trueColor
  4. to stacks that are colorized using Apple's Color Tools.
  5.  
  6. I wrote this stack to ease an eventual transition to HyperCard 3.
  7.  
  8. trueConvert requires HyperCard (Player) 2.2 or later,
  9. and the stack "trueColor".
  10.  
  11. If you have HyperCard 2.1, you can use it for creating your
  12. stacks in trueColor, and then convert them using HyperCard
  13. Player 2.2 or later (available free from Apple on the internet).
  14.  
  15.  
  16. Important Note
  17.  
  18. Note that "trueConvert" will place a copy of Apple's AddColor XCMD,
  19. version 2.2, into the converted stack. This means that you may distribute
  20. the converted stack only if you are a registered user of HyperCard 2.2.
  21.  
  22. If you own a full version of HyperCard 2.3 or newer you can upgrade
  23. the converted stack by opening it and choosing "Open Coloring Tools"
  24. from the "Color" menu. This will place the newer version of Apple's
  25. AddColor XCMD (and a PowerPC native version of it) into the stack.
  26.  
  27. The following paragraph is from Apple's Color Tools Stack, version 2.2:
  28.  
  29. Registered users of HyperCard v2.2 may freely distribute the AddColor XCMD
  30. for personal and commercial purposes.  Any product or stack containing these
  31. resources must display the following copyright notice:
  32. "AddColor XCMD ©1993 Apple Computer, Inc. All Rights Reserved."
  33.  
  34.  
  35. How to use it
  36.  
  37. The converter lets you choose a stack, creates a copy
  38. and converts the copy. It goes from card to card during conversion
  39. so that you can see the results immediately. 
  40. (you can stop the conversion by pressing the mouse down.)
  41.  
  42. You can specify the number of colors for the color
  43. buffer that will be created each time the converted stack is opened:
  44. use the "image quality" of trueColor's pasting options (ctrl-o).
  45. If you choose "don't change", the number of colors of the current
  46. card screen (at conversion time) will be taken.
  47.  
  48. If the conversion stops with the message
  49. "Error: AddColor incorrectly installed." or if it just stops and beeps,
  50. the problem is probably lack of memory.
  51.  
  52. The converted stacks can be viewed in HyperCard 2.1 or later.
  53.  
  54. The conversion is not perfect:
  55. - showing and hiding in color will not work
  56. - pictures and icons will not be clipped at the rectangle
  57.    of the button or the field
  58.  
  59.  
  60. Scripting
  61.  
  62. trueConvert s
  63.  
  64. s is the name of the stack to convert.
  65. trueColor's global variable truePasteColor is used for
  66. the bit depth in "AddColor install, depth" at openStack.
  67.  
  68. trueConvert copies several resources, including the AddColor XCMD
  69. and inserts some scripts at the stack level, namely the ones required
  70. for the Color Tools and also handlers which translate trueShow and
  71. trueHide into show and hide.
  72.  
  73. Color fillings for buttons and fields are created by the "addButton"
  74. and "addField" options of the AddColor XCMD, except for transparent
  75. parts which are colorized by "addRect" (else they would show in
  76. lighter colors).
  77.  
  78. Pictures and icons are added by "addPict".
  79.